home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / gettext / intl / relocatable.h < prev    next >
Encoding:
C/C++ Source or Header  |  2010-09-19  |  3.1 KB  |  84 lines

  1. /* Provide relocatable packages.
  2.    Copyright (C) 2003, 2005, 2008 Free Software Foundation, Inc.
  3.    Written by Bruno Haible <bruno@clisp.org>, 2003.
  4.  
  5.    This program is free software; you can redistribute it and/or modify it
  6.    under the terms of the GNU Library General Public License as published
  7.    by the Free Software Foundation; either version 2, or (at your option)
  8.    any later version.
  9.  
  10.    This program is distributed in the hope that it will be useful,
  11.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13.    Library General Public License for more details.
  14.  
  15.    You should have received a copy of the GNU Library General Public
  16.    License along with this program; if not, write to the Free Software
  17.    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
  18.    USA.  */
  19.  
  20. #ifndef _RELOCATABLE_H
  21. #define _RELOCATABLE_H
  22.  
  23. #ifdef __cplusplus
  24. extern "C" {
  25. #endif
  26.  
  27.  
  28. /* This can be enabled through the configure --enable-relocatable option.  */
  29. #if ENABLE_RELOCATABLE
  30.  
  31. /* When building a DLL, we must export some functions.  Note that because
  32.    this is a private .h file, we don't need to use __declspec(dllimport)
  33.    in any case.  */
  34. #if HAVE_VISIBILITY && BUILDING_DLL
  35. # define RELOCATABLE_DLL_EXPORTED __attribute__((__visibility__("default")))
  36. #elif defined _MSC_VER && BUILDING_DLL
  37. # define RELOCATABLE_DLL_EXPORTED __declspec(dllexport)
  38. #else
  39. # define RELOCATABLE_DLL_EXPORTED
  40. #endif
  41.  
  42. /* Sets the original and the current installation prefix of the package.
  43.    Relocation simply replaces a pathname starting with the original prefix
  44.    by the corresponding pathname with the current prefix instead.  Both
  45.    prefixes should be directory names without trailing slash (i.e. use ""
  46.    instead of "/").  */
  47. extern RELOCATABLE_DLL_EXPORTED void
  48.        set_relocation_prefix (const char *orig_prefix,
  49.                               const char *curr_prefix);
  50.  
  51. /* Returns the pathname, relocated according to the current installation
  52.    directory.
  53.    The returned string is either PATHNAME unmodified or a freshly allocated
  54.    string that you can free with free() after casting it to 'char *'.  */
  55. extern const char * relocate (const char *pathname);
  56.  
  57. /* Memory management: relocate() potentially allocates memory, because it has
  58.    to construct a fresh pathname.  If this is a problem because your program
  59.    calls relocate() frequently, think about caching the result.  Or free the
  60.    return value if it was different from the argument pathname.  */
  61.  
  62. /* Convenience function:
  63.    Computes the current installation prefix, based on the original
  64.    installation prefix, the original installation directory of a particular
  65.    file, and the current pathname of this file.
  66.    Returns it, freshly allocated.  Returns NULL upon failure.  */
  67. extern char * compute_curr_prefix (const char *orig_installprefix,
  68.                                    const char *orig_installdir,
  69.                                    const char *curr_pathname);
  70.  
  71. #else
  72.  
  73. /* By default, we use the hardwired pathnames.  */
  74. #define relocate(pathname) (pathname)
  75.  
  76. #endif
  77.  
  78.  
  79. #ifdef __cplusplus
  80. }
  81. #endif
  82.  
  83. #endif /* _RELOCATABLE_H */
  84.